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I. Introduction 


welcome to the 2X Assembler/Disassembler by Bob serch. The 
primary purpose of this program is to help you write and debug 
machine code programs. included in this one program is an assembler 
utilizing standard Z80 mnemonics, a disassenbler giving hex or 
decimal output to the screen or printer, a hex or decimal memory 
editor, a REM generator to make REM statenents to save machine 
code in, and a set of binary SAVE and LOAD routines. The program 
is a little over 4K long and is supplied on cassette in two versions, 
back to back: 
1. Hi-rem, above RAMTOP, program at 28-32K. Those with only 
J a 16K rampack (the minimum configuration) must use this one. 
2. Lo-rem, in the ROM transparent area, program at 12-16K, 
To use this version you must have menory in this area as 
with a 64K Rampack or a Hunter board. 
In addition, this program is available on EPROM in the lo-mem 
version, without the LOAD and SAVE routines, as an exactly IK 
program, A plug-in cartridge kit is available to hold the EPROM. 


If you can use the lo-ren version,it is recomended you do so 
as you will find it more out-of-the-way and also more immune to 
crashes from your generated machine code gone haywire. 


This manual will not attempt to teach you machine code pro- 
gramming and you are refered to some of the many Z80 books on the 
market in appendix D „ You are given sample programs in part IV 
aná a fairly complete list of usable ROM routines and their calling 
sequences in appendix C and a similar list cf usable Assembler/ 
Diaassenbler routines in appendix B, 


To load the tape, choose the proper version,and use the name 
"ASMB!. It will auto-boot itself in place and the hi-mem version 
will lower RAMTOP, A title page will be displayed. 


Assembly language source code for the assembler is entered 
under Basic in REM statements; the specifications are given below. 
The Assembler/Disassembler is called with a RAND USR command and 
the assembly is started by pressing the Z key. If no errors are 
found, the object code is deposited ina string named Aj. Here it 
may be viewed with the disassembler, moved to another part of memory 
or a REM statement, edited, or saved as a binary file. 


The RAND USR command for each version is? 
low-mem RAND USR 13616 
hi-mem RAND USR 30000 


Once the RAND USR call has been made, the various functions 
of the Assembler/Disassembler are called with single letter 
key commands (letters A to Z). An asterisk in the lower left 
of the screen signifies a wait for ons of these commands. 





11. The Key Commands 


First, observe the four display modes illustrated below: 
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Data Mode 


Decimal 


Hex 
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In disassembly trode, the leftmost column of numbers is 
the address, the raw data at those addresses is at center, and 
the assembly mnemonics are at the right. 


In data mode there are five columns: the leftmost and 
rightmost columns are the addresses (in hex and decimal), next 
in is the data at each address (also in hex or decimal), and 
finally in the center is the Sinclair character equivalent of 
that data, 


Now, the key commands in detail: 


A enter address. A > will appear ( or a > if you are in hex 
mode) and you enter the digits for the address for the top of 
the page (TOP). Hex addresses are always four digits and need 
no return. Decimal addresses always need a return. The delete 
key deletes the entire entry and you start again. 


B looks backward in memory. If you're in data mode, you go back- 
ward 22 addresses, If you're in disassenbly mode, you go back 
30 addresses. Disassembly backpages will genzrally overlap, 
but occasionally will not, as with a field of all NOP's. In 
addition, disassembly backpages will often land in the middle 
of a multi-byte instruction and the first instruetlon or two 
will be gibberish. Just be aware of it. 


C continue looking foward in memory., In both data and disassembly 
mode the top of the new screen starts with the byte after 
the last byte on the present screen, 


D data/disassembly switch. Changes from disassembly to data mode 
and back again, 


E edit memory. If in disassembly mode, you will be changed to 
data mode. A cursor will appear at the top address and an 
input prompt (hex or decimal, depending on what mode you were 
in last) at the bottom left. Hex data is two digits and needs 
no return; decimal data always needs a return. Entered data 
will be poked into memory at the cursor address aná the cursor 
will be moved down the page. The up and down arrow keys can 
be used to move the cursor over any addresses, 


FP set the EOF address, that is the end of file address. Thi 
address is used by the L, M, 3, T, and X commands. ; 


G generate a REM. Enter the number of spaces desired within the 
REM. Makes a 1 REM filled with x's. 


E hex/deoifial switch. Changes from hex to deoimal mode and baok 
again, 











L load binary. 


Use tle A command to set the first address to 


be loaded and the F command to set the last. A load will 
procede until the last byte is loaded or the break key 


is pressede 


M move memorye 


Moves a block of memory between and including 


The TOP address ((Z] cursor) and the EOF address to the 
address entered on the input prompt. The EOF address must 
be greater than the TOP address. If the block of memory 


overlaps its 


future position, this routine intelligently 


avoids overwriting it by choosing a top-down or bottom-up 


move. 


á (shifted) quit. 


Used to exit any input prompt to get the 


asterisk or to leave the asterisk to return to Basic. 


3° save binary. 


This is the complement of L, of course. Use 


the A anf F commands to set the limits to save} you save 
up to and including: the EOF byte. 


Besides being used to to save files of your assembled 
code, these commands can be used to load and list *'unlist- 
able! programs or load, edit, and save damaged tapes. 

No name or header is saved with these files, just raw data. 


During a save, pressing break will return to Basic. 


T type output, 


Outputs to a Timex or Sinclair printer, in 


whatever mode you are in, the present and consecutive 
screens up to the EOF address. Like save, you may break, 
but will be returned to Basic. 


xX clear. Sets to zeros all memory from the TOP address to 
and including the EOF addresse 


Z assemble. Read on. 


Note: some commands ask OK? before proceding. A ty! or an 
enter Will procede. A 'N', a ‘break’ or a shifted y will allow 


you an escape. 





III. The Assenbler 


Before calling the assembler (with the Z cormand), the 
source code must be entered and present in memory. This is done 
under Basic, entering each statement in a REM statement. 

Here are the rules: 


i. The operation code must be immediatly after the REM followed 
by one or more blanks or an end of line. The operand follows, 
parts of the operand seperated by a comma, then an optional 
semi-colon and comments. Blanks are ignored in the operand but 
must not appear in the op code. A line full of comments starts 
with a semicolon, 

*,Your REM statements are edited or deleted like any Basic 
statement. 


2. In the operand, variables in the Basic variable area may be 
used in place of eny number. Variables so defined must be at 
least three characters long and not start with the letter He 
Define the variables with LET statements, either in immediate 
mode or as progr:m statements after a END statement (see below) 
The second way better documents your program. Remember to 'RUN®* 
your program before calling the assembler to execute your Lets. 


3. Hexadecimal constants are preceded by an 'H' and are two, 
three, or four digits long. when only two digits are given for 
a 16 bit constant, they will be the low order byte. 

Decimal data is accepted in the range zero to 65535, 

Character data within quotes is allowed, one or two 

characters long. More than two characters may be given, but 
only the last two are recognized. Any character code is allowed 
except the quote (0Bh) and the enter (76h). 


examples: 

valid constants invalid constants 
‚4543 (0543h) +1 

tz? (14h or 0014h) 70000 

8193 (200ih) H? 

"WXYZ" = (3E3Ph) -1 


4, Branch instructions use the line number or a variable 
equal to a line number to reference an address, or you may 
use an absolute address. To reference a line number, puta 
slash in front of the number. LD instructions may also use 
a slash in front of a number to reference a line in the program. 


examples i 
CALL /1200 calls the subroutine at line 1200 i 
JR /80 jumps to line 80 

















6. 


CALL HOA2A calls the ROM routine at OA2Ah 


LD HL,/TB1 where TB1 is defined by a LET statement 
at the end of the program as some line 
in the program, HL is loaded with the 
address of that line, 


Instructions are exactly as printed in the 2X81/T51000 


manual appendix with two small exceptionss 


ea. 
used 


7e 


le EX AF,AF! should leave out the prime sign (that is, 
| EX AF,AP ). 


2. IM 0, IM 1, and IM 2 are written without spaces (that 
is, IMO, IM1, and IM2) 


Note, this is how the disassembler prints them, too, 


As an optional shorthand device, the E: symbol may be 
in place of *(HL)'. 


There are four pseudo-0ps8t j 


1. ORG specifies the run-time address for the first 
instruction in your program. If used more than once, only 
the last ORG is recognized, If no ORG is given, 16514 is assumed. 


2. DATA puts data in memory in sequence with the rest 

of your code, There is no limit to the number of operand 
parts, each seperated by a comma. There are three catagories 
of operand parts allowed: 


a. simple constants or variables. If the value is between 
O and 255, it is stored as one byte. If the value is 
between 256 and 65535 it is stored as two bytes, low byte 


‘first. Note, to store H0001 as two bytes you must use 


‚ #01, HOO . 


b. string data, In DATA statementa only, any number of 
characters within quotes is stored in entirety. Same rule 
concerning no quotes or enters. 


Co line number address. You may use a slash in front of 
a constant or variable to store a line number address, but 
then make that the only operand part in that DATA statement, 
3. RESV puts a specified number of zeros in memory. 

ex. RESV 5 is the same as DATA 0,0,0,0,0 


4. END is required as the last statement of your souroe 
code. 
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Having entered your source code, call the assembler 
with a RAND USR xxxxx (depending on version) and then Z. 
If the assembler finds errors, it will print "ASScHBLY ERROR? 
and a report with an error number and line number. The report 
codes are in appendix A. You will be left in Basic to edit 
your mistake; do so, and recall the assembler, 


If no errors are found, the output code will be deposited 
in a string named Aj. You will be put in disassembly mode 
with the top of the page as the first byte of your code and 
the EOP set to the last. With this, you are set to use the 
move or save commands. If you move the display, make note of 
the TOP address so you can find it later. 


x 
3 


Tips 


It is considered good programming to be liberal with 
comments. Especially with this assembler, where line numbers 
are used over labels for referencing, you have lost a certian 
readability good comments will restore. 


Of course, save your source code before you run your 
program, for even simple mistakes may crash the system requiring 
you to reset the machine. If you save your source right after 
an EN (with the Basic SAVE), A$ will be saved along 
with 1 . 


If you are going to run your code in a i REM statement 
(location 16514 and on), you may want to generate the REM 
before you assemble, Make it at least as big as you expect 
the code to be (you can estimate high with no 11] effects), 
and change the first character to a semioolon so the assembler 
will ignore it. Assemble, move the code to 16514 (4082 hex) 
(TOP and EOF are already set, but check the length), and try 
your programe. 


To save your machine code ina 1 REM without the source 
code, move the code block to a protected part of memory (8 to 
16K or above a lowered RAMTOP) or save your code to tape. 
Execute a NEW, then generate a REM and reload your code into it. 
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Sample Prograns 


ZEM AIK KKK EK 
ZEM  *sHORIZANTAL LEFT ++ 
=Et4 „#3444 SCROLL 44444% 
ZEM LD E,22;LINE COUNTER 
SEM LO HL, (OF IL); 15T LINE 


ZEM L BC,32 
SEM INC HL; 13T POSITION 


EM LD A, E; SAVE FOR WRAP 
SEM FUSH HL 

=EM Für DE 

SEM INC HL 

SEM LDIR ; SCROLL 1 LINE 
ZEM DEC RL : 

ZEM LD £,A;FILL LAST FOS, 
=EM INC HL 

=EM DP EC 

SEM LINZ 728 ¿LOOP 

IEH : 

SEM “ET 

ZEM END 

„ET SPFIL=:153906 

FOTI Beas 

EM 

EN ERST PROGRAM 

FOR Fal TO 300 

SRINT AT EAND:21,AND:31;,"."; 
MEXY I 

¿LO 

„ET TzU5SR 16514 

UT 2408 


This 23 byte program moves 
everything in the display to 
the left one position and filis 
in the last column with the 
contents of the first. It 
assumeg a fully expanded display 
file, 

Note a. 1 RöM has been 
generated (and the first char- 
acter changed to a semi-colon) 
to move the code after assemblya 

The test program puts 
300 random asterisks on the 
screen then continually calls 
our scroller. 

Replace line 26 with: 

26 REM SUB A 
for a non-wrap-around scroll, 


After assembling, move 
the code to the 1 REM and call 
the test program with a GOTO 
200. a 
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— KKK KK AK KK HHI I I a graphics progran, 

es here playing with the character 
Sa B AE F table in the upper 512 bytes of 
REM ¡CHAR AT LOC. 18507 ROM. Code to be displayed is 
ae ‚SCREEN POS. ON LINE 34 passed through tne unused sys- 
REM ip A, (16507?) tem byte at 16507. Two ROM 
FEM LD DE,HIEQ® ; CODE+3 + routines are called: Print aT 
Ben F AE AR A and print a character. Two loops 
REM ADD HL,HL ; PÒS. are set up to process the 
REM ROD HL,HL lines and the 8 bits per line, 


REM LD E,3 ¡LINE CTR. 
FEM LD BO, HOSeC ;PRINT POS. 


2 
FEM PUSH EC 
REM PUSH DE 
FEM PUSH HL 
REM CALL H08FS ; PRINT AT 


FEM FOP HL 

REM ; 

REM LD C, ; P/U BYTE 
REN LO 8,& ;BIT CTR, 
REM FL C ¡TEST BIT 
FEM LO A, RR” 

REM UR C,7728 

REM ZUS A 

REM RST H1 ; PRINT 
REM DUNZ 6 

REM ; 

REM POP DE 

REM POP BC 


REM INC HL ; NEXT BYTE 
REM INC B ; NEXT LINE 


REM JR NZ,/40 
RET 
REM END 


REM TEST PROGRAM 

LET A=CODE INKEYS 

IF A=2 THEN GOTO 21a 
FOKE 165087, 

RAND USR 16514 

GOTO 210 














Assembler x£rror Reports Appendix A 


The error report is given similar to Basic errors, that 
18, error number ~ slash - line number. These error numbers 
apply: 


1 NON REM STATEMENT or NO END STATEMENT. Only REMs are 
allowed before the REM END and the REM END is required. 


2 INVALID OP CODE. Neither a Zilog mnemonic nor « ZX Assembler 
pseudu op has been found. Remember, blanks are not allowed 
before or within the op code. 


3 BAD OPERAND SYNTAX. This is the largest category and 
could be many things. Check for correct number of operand 
parts, spelling, punctuations, or the use of parenthesis. 


iy VARIABLE NOT FOUND. You have specified a variable which 
can't be found in the Basic variable area, Perhaps you 
forgot to "RUN® through your LETs. 


5 DATA OUT OF RANGE. You have given a value greater than 


255 where 8 bits is required or 65535 where 16 bits is 
required. 


6 PROGRAM TOO LARGE. The assembler has encountered insufficient 
head room to process the assembly. You must either raise 
RAMTOP or assemble your program in two or more segments. 


7 JUMP DISPLACEMENT TOO LARGE. You have asked for a JR or 
DJNZ instruction to jump over 128 bytes away. Change to 
a JP instruction, 


8 INVALID LINE NUMBER. You have referenced a line number 
beyond the end of your program, 
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Useful Assembler/Disassembler Routines Appendix B 


> The Assembler/Disassenbler contains some machine code 
routines which you might want to use or maybe look at with the 
disassembler and glean some interesting techniques. They are 
given here with the address for the hi-mem version. Subtract 
4000h to get the low-mem address. 


address my name description 


7FEA INKY reads the keyboard returning the 
l character value in the A reg. anå the 
L reg.. No key pressed returns zero, 
the break key 255, and the shift key 254, 


7PDP INKW i waits for a no key condition, then 
; calls INKY. 
7F6C = PRIN prints the contents of HL. Location 


16417 (4021h) is used as a control byte 
as follows: 
bit 0 reset - print decimal 
set - print hexadecimal 
bit 1 reset - signed decimal — 
set - unsigned decimal 
bit 7 reset - 4 hex digits 
set - 2 hex digits 





7PD1 PC1 prints the character or token of the 
code in the A rege 


7 FBO PRTC prints the characters following the 
call until a 70h byte is reached. 





7FC6 * TAB tabs the print position to the column 
. specified by the L reg., setting to 
blanks everything on the way. 


TELA INPUT inputs a number to HL, prompting as 
' described for the assembler/disassembler. 

Location 402ih is used as described 
for PRTN. A shifted Q will set the carry. 


771E SCRDN scrolls the screen down and seta the 
print position at 0,0. 


770B SCRUP scrolls the screen up and sets the 
print position at 21,0. 


The table of 26 addresses for each key command starts at 
74FC. You may further explore the assembler/disassembler by 
tracking down those addresses. Unassigned keys are routed to 
754E. You may want to change unassigned kep to jump to your own 
routines, 





12 


Useful ROM Routines Appendix C 


Here are described many of the useful ROM routines, There 
are more, but they are often difficult to utilize. For in-depth 
explainations, consult Dr. Ian Logan's disassenblies. 


address 


0000 RST 0. Not really useful, but you should know this 
is the cold start for the system. Cleara RAM, sets 
up a display file, etc, 


0008 - R3T 8, The error restart. Prints the Basic error 
message. The byte following this call is incremented 
and taken as the error number, Line number is taken 
from PPC (4007h). 


0010 RST 16. Print a character. Code is taken from the 
A reg. and must be 0-3Fh, 80h-BFh, or 76h, else 
you will crash. AF, BC, DE and HL are all saved 
and restored. 

If bit 1 of FLAGS is set, output will be sent to 
the printer, 


0028 R3T 40, The floating-point.calculator. This facinating 
routíne takes up about one-third of the ROM and 
performs all the Basic arithemetic functions and 
operations plus a number of special internal ones, 
The bytes following this call are treated as instruc- 
tions to manipulate data (five bytes each entry) 
on the calculator stack. The end of this instruction 
string is signaled by a 34h byte, Not just numbers, 
but strings are manipulated by this caloulator, 
their 5 byte entries containing address and length 
pointers. The list of instruction codes is given at 
the end of this section. RST 40 does not save and 
restore most registers. 


02BB Scan keyboard. Returns in HL the 16 bit ‘key value’, 

O31E Save one byte, Outputs to the cassette port the byte 
pointed to by HL. Unfortunatly, there is no simple 
similar routine for loading. 

07BD Decode keyboard. Takes 16 bit *key value! from BC and 
returns with HL pointing to the proper character 
in the tables 007£ to 0110. 

0869 Copy soroen, Just like the Basio command. 


08P5 Print AT. Enter with line no. in B reg. aná column 
no. in C reg. Computes new DF-CC with error checking. 
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1308 


1494 


1520 


1584 


‘Make rom’, Used by the system to insert lines, 
variables, expand the display file, etc. Updates 
the system pointers when through. From (HL), makes 
BC spaces. CALL 099B makes one space, 


Finds the address of a line number in a Basic program., 
Enter with line no. in HL; exit with address in HL. 


Clears the bottom screen and does a Print AT 23,0, 
Clears total screen, just 11% Basic command. 
Reclaim memory. Used by the system to delete lines, 
variables, etc. At HL, deletes BC spaces, updating 
the necessary system pionters. 


outputs a decimal number, up to 9999, taken from 


BC reg. 


prints a string of characters, including tokens, 
pointed to by DE with length BC. 


Plot, unplot, Enter with B reg. holding Y coordinate, 
C reg. holding X. To plot, poke T-ADDR (4030h) with 
AOh; to unplot, poke it with O. 

Scroll, just like Basic, 

Fast, just like Basic, dd 

Slow, just like Basio. 

Tests break key and carry is set if not pressed, 
Debounce keyboard. Call after a keyboard read, 
Finds variables in the variable area, To call, load 
CH_ADD (4016 & 7) with the address of a string of 
tha name of the variable you wish to find, Also, 
bit 7 of the C reg. must be reset. On return, the 
carry will be set 1f no name was found, or the 
carry “ill be reset and HL will point to the last 
letter of the name in the variable area. Increment 
HL and you may pickup the value of the variable, or 
if an array or string, its length parameters. 

16 bit multiply. HL = HL * DE, 

Clears the variable area. 


BC to floating point. Converts the number in the BC 
reg. to a 5 byte f.p. number on the f.p. stack, 


F.P. to BC. Opposite of BC to fepe Carry is set if 
result is greater than 655350 


14 


— ——— VKU ann OE NaN Sa 





Calculator instructions 


code 

00 Jump. if stack top is true, 
displacement byte follows 

01 exchange top two values 

02 delete top value . 

03 subtracts top value from 
2nd value. 

0% multiplies top two vulues 

05 divides 2nd entry by top 

06 2nd entry to power of ist 

07 ORs top two numbers  ' 

08 ANDs top two numbers 

09 less than or equal operation 

OA greater than or equal op. 

OB not equal op. 

oc greater than op. 

OD less than op. 

og equal to op, 

OF addition op. 

10 ANDs a string and a number 

11 string <= op, 

12 string => op, 

13 string <> op, 

14 string > op. 

15 string < op. 

16 string = op. 

17 adds two strings 

18 negates top number 

19 CODE function 

1A VAL function 

1B LEN function 

ic - SIN function 

1D COS function 

1E TAN function 

iF ASN function 

20 ACS function 

21 ATN function 

22 LN function 

23 EXP function 

24 INT function 

25 SQR funotion 

26 SGN function 

27 ABS function 

28 PEEK function 

29 USR function 

2A STR function 

2B CHR$ function 
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code 


through 
C5 


E0 
through 
E5 


NOT function 
duplicates top entry 
divides,returns int. 
quotient and remainder 
unconditional jump, 
displacement follows 
stack a number, data 
follows 

DJNZ (using BERG), 
disp. follows 

less than 0 test 

gre than 0 test 


‚end calculation 


used by trig. functions 
integer truncation 
execute f.p. op. in 
A reg. 
converts E-format to 
floating-point 
calls seris generator 
for trig. and log, 
functions 
stacks a 0 
stacks a 1 
stacks 4 
stacks pi/2 
stacks 10 decimal 
stores top f.p. 
entry in system 
MEMBOT area 
recalls MEMBOT 
entry to the 
f.p.staok 





Useful Books Appendix D 


It is recomended you purchase two *Bibles' 1 
1. A manual on the Z80 chip. If possible, go to a bookstore 


or book department of a computer store and choose one whose 
style you like. In the field are: 


The 280 Assembly Language Programming Manual and The 280 
Technical Manual by Zilog 


Z80' Assembly Language Programmirig by Lance Leventhal, 
Osborne/McGraw Hill 


w to Program the Z80:by Rodnay Zaks, SYBEX 
The last one is available at Radio Shack stores. 


2. A manual on the 8K ROM. There is only one and it is good: 


Sinclair 2X81 ROM Disassembly Parts A & B by Dr. Jan Logan, 


Melbourne House 


In addition, there are a few books out specifically on 
the Zx81 and machine code: 


Mastering Machine Code on the ZX81 by Toni Baker, Reston 


Machine language Programming Kade Simple by Michael Roberts, 
Melbourne House 

Understanding Your ZX81 ROM by Dr. Jan Logan, Melbourne 
House 


Mastering Machine Code is quite good. It explains tine 280 
chip fully, Bat spends less time on this than the other books, 
instead delving right into many meaty sample programs, ways to 
save machine code, and even using the floating-point calculator, 

and Understanding the ROM are primarily 
tutorials on the Z80 chip and its instructions. Made yinple 
quickly desoribes only one full-blown sample program (cheokers), 
uses bits of the ROM as examples, but only has 
one thin chapter on ite overall organization, 
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V1.0 Notes 


In the assembler, JR and DJNZ instructions cannot reference 
absolute addresses. In fact, the slash is actually optional; 
they will always reference line nos. 


On indexed instructions utilizing a displacement, that 
displacement may only be a decimal number, not hex. The 
acceptable range on that number is -128 to +127. However, 
during disassembly in decimal mode, the displacement is printed 
as a decimal number O to 255, 255 being equivalent to -1, etc. 


The instruction in the form LD (X¥4d),N (indexed 36h 
instruction)is mis-disassembled as a three byte instruction 
instead of four, the third byte being used twice. Examples in 
the ROM of this bug start at O6hln. 
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